home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 November / SGI Freeware 1999 November - Disc 1.iso / dist / fw_expect.idb / usr / freeware / catman / u_man / cat1 / xkibitz.Z / xkibitz
Text File  |  1999-01-26  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666    OOOOccccttttoooobbbbeeeerrrr    1111999999994444))))        XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       xkibitz - allow multiple people to interact in an xterm
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       xxxxkkkkiiiibbbbiiiittttzzzz [ _x_k_i_b_i_t_z-_a_r_g_s ] [ _p_r_o_g_r_a_m _p_r_o_g_r_a_m-_a_r_g_s... ]
  13.  
  14.      IIIINNNNTTTTRRRROOOODDDDUUUUCCCCTTTTIIIIOOOONNNN
  15.       xxxxkkkkiiiibbbbiiiittttzzzz allows users in separate xterms to share one shell
  16.       (or any program that runs in an xterm).  Uses    include:
  17.  
  18.            +o   A novice user can ask an expert user    for help.
  19.            Using xxxxkkkkiiiibbbbiiiittttzzzz, the expert can see what the user is
  20.            doing, and offer advice or show how to do it    right.
  21.  
  22.            +o   By running xxxxkkkkiiiibbbbiiiittttzzzz and then starting    a full-screen
  23.            editor, people may carry out    a conversation,
  24.            retaining the ability to scroll backwards, save the
  25.            entire conversation,    or even    edit it    while in
  26.            progress.
  27.  
  28.            +o   People can team up on games,    document editing, or
  29.            other cooperative tasks where each person has
  30.            strengths and weaknesses that complement one
  31.            another.
  32.  
  33.            +o   If you want to have a large number of people    do an
  34.            on-line code    walk-through, you can sit two in front
  35.            of each workstation,    and then connect them all
  36.            together while you everyone looks at    code together
  37.            in the editor.
  38.  
  39.      UUUUSSSSAAAAGGGGEEEE
  40.       To start xxxxkkkkiiiibbbbiiiittttzzzz, one    user (the master) runs xkibitz with no
  41.       arguments.
  42.  
  43.       xxxxkkkkiiiibbbbiiiittttzzzz starts a new shell (or another program, if given on
  44.       the command line).  The user can interact normally with the
  45.       shell, or upon entering an escape (described when xkibitz
  46.       starts) can add users    to the interaction.
  47.  
  48.       To add users,    enter "+ display" where    display    is the X
  49.       display name.     If there is no    ":X.Y" in the display name,
  50.       ":0.0" is assumed.  The master user must have    permission to
  51.       access each display.    Each display is    assigned a tag - a
  52.       small    integer    which can be used to reference the display.
  53.  
  54.       To show the current tags and displays, enter "=".
  55.  
  56.       To drop a display, enter "- tag" where tag is    the display's
  57.       tag according    to the "=" command.
  58.  
  59.       To return to the shared shell, enter "return".  Then the
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666    OOOOccccttttoooobbbbeeeerrrr    1111999999994444))))        XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       keystrokes of    all users become the input of the shell.
  75.       Similarly, all users receive the output from the shell.
  76.  
  77.       To terminate xxxxkkkkiiiibbbbiiiittttzzzz it suffices to terminate    the shell
  78.       itself.  For example,    if any user types ^D (and the shell
  79.       accepts this to be EOF), the shell terminates    followed by
  80.       xxxxkkkkiiiibbbbiiiittttzzzz.
  81.  
  82.       Normally, all    characters are passed uninterpreted.  However,
  83.       in the escape    dialogue the user talks    directly to the
  84.       xxxxkkkkiiiibbbbiiiittttzzzz interpreter.    Any EEEExxxxppppeeeecccctttt(1) or TTTTccccllll(3)    commands may
  85.       also be given.  Also,    job control may    be used    while in the
  86.       interpreter, to, for example,    suspend    or restart xxxxkkkkiiiibbbbiiiittttzzzz.
  87.  
  88.       Various processes can    produce    various    effects.  For example,
  89.       you can emulate a multi-way write(1) session with the
  90.       command:
  91.  
  92.            xkibitz sleep 1000000
  93.  
  94.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  95.       xxxxkkkkiiiibbbbiiiittttzzzz understands a    few special arguments which should
  96.       appear before    the _p_r_o_g_r_a_m name (if given).  Each argument
  97.       should be separated by whitespace.  If the arguments
  98.       themselves takes arguments, these should also    be separated
  99.       by whitespace.
  100.  
  101.       ----eeeessssccccaaaappppeeee sets the escape character.  The default escape
  102.       character is ^].
  103.  
  104.       ----ddddiiiissssppppllllaaaayyyy adds    a display much like the    "+" command.  Multiple
  105.       -display flags can be    given.    For example, to    start up
  106.       xkibitz with three additional    displays:
  107.  
  108.            xkibitz -display    mercury    -display fox -display
  109.       dragon:1.0
  110.  
  111.  
  112.      CCCCAAAAVVVVEEEEAAAATTTTSSSS
  113.       Due to limitations in    both X and UNIX, resize    propagation is
  114.       weak.
  115.  
  116.       When the master user resizes the xterm, all the other    xterms
  117.       are logically    resized. Unfortunately,    xkibitz    cannot force
  118.       the physical xterm size to correspond    with the logical xterm
  119.       sizes.
  120.  
  121.       The other users are free to resize their xterm but their
  122.       sizes    are not    propagated.  The master    can check the logical
  123.       sizes    with the "=" command.
  124.  
  125.       Deducing the window size is a    non-portable operation.     The
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/23/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666    OOOOccccttttoooobbbbeeeerrrr    1111999999994444))))        XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       code is known    to work    for recent versions of SunOS, AIX,
  141.       Unicos, and HPUX.  Send back mods if you add support for
  142.       anything else.
  143.  
  144.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  145.       The environment variable SHELL is used to determine and
  146.       start    a shell, if no other program is    given on the command
  147.       line.
  148.  
  149.       If the environment variable DISPLAY is defined, its value is
  150.       used for the display name of the xxxxkkkkiiiibbbbiiiittttzzzz master (the display
  151.       with tag number 0). Otherwise    this name remains empty.
  152.  
  153.       Additional arguments may be passed to    new xterms through the
  154.       environment variable XKIBITZ_XTERM_ARGS.  For    example, to
  155.       create xterms    with a scrollbar and a green pointer cursor:
  156.  
  157.            XKIBITZ_XTERM_ARGS="-sb -ms green"
  158.            export XKIBITZ_XTERM_ARGS
  159.  
  160.       (this    is for the Bourne shell    - use whatever syntax is
  161.       appropriate for your favorite    shell).    Any option can be
  162.       given    that is    valid for the xxxxtttteeeerrrrmmmm command, with the
  163.       exception of ----ddddiiiissssppppllllaaaayyyy, ----ggggeeeeoooommmmeeeettttrrrryyyy and ----SSSS as those are set by
  164.       xxxxkkkkiiiibbbbiiiittttzzzz.
  165.  
  166.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  167.       TTTTccccllll(3), lllliiiibbbbeeeexxxxppppeeeecccctttt(3) kkkkiiiibbbbiiiittttzzzz(1)
  168.       "_E_x_p_l_o_r_i_n_g _E_x_p_e_c_t: _A _T_c_l-_B_a_s_e_d _T_o_o_l_k_i_t _f_o_r _A_u_t_o_m_a_t_i_n_g
  169.       _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s"    by Don Libes, O'Reilly and Associates,
  170.       January 1995.
  171.       "_k_i_b_i_t_z - _C_o_n_n_e_c_t_i_n_g _M_u_l_t_i_p_l_e    _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s
  172.       _T_o_g_e_t_h_e_r", by    Don Libes, Software - Practice & Experience,
  173.       John Wiley & Sons, West Sussex, England, Vol.    23, No.    5,
  174.       May, 1993.
  175.  
  176.      AAAAUUUUTTTTHHHHOOOORRRR
  177.       Don Libes, National Institute    of Standards and Technology
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/23/98)
  196.  
  197.  
  198.  
  199.